home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 26 / AACD 26.iso / AACD / System / envhandler / env-handler.doc < prev    next >
Encoding:
Text File  |  2001-09-05  |  5.5 KB  |  146 lines
  1.  
  2.         env-handler
  3.  © 2001 by Stephan Rupprecht
  4.     All rights reserved.
  5.  
  6.  
  7. COPYRIGHT AND DISCLAIMER
  8.  env-handler is copyrighted 2001 by Stephan Rupprecht. 
  9.  All rights reserved. This program is freeware, so no financial
  10.  donations required. Redistribution allowed if the package is 
  11.  left unchanged. The author is not responsible for any damage 
  12.  caused by the use or misuse of this documentation and/or the 
  13.  program(s) it describes.
  14.  
  15.  All mentioned trademarks are subject to their respective owners.
  16.  
  17.  
  18. REQUIREMENTS
  19.  - Any Amiga® (compatible) computer with at least OS3.0.
  20.  - 68020-60cpu.
  21.  
  22.  
  23. DESCRIPTION
  24.  env-handler is a RAM disk specialized for enviroment variables
  25.  that are usually located in RAM:Env. This program does pretty
  26.  much the same as HappyENV by Martin Gierich, so you probably
  27.  wonder why I wrote another program of this kind. The reason
  28.  for this is simply that HappyENV is very buggy and at least
  29.  v1.1 doesn't even work here on my system. The advantages of
  30.  env-handler over RAM:Env are:
  31.  
  32.  - low memory usage
  33.  - faster access to env variables
  34.  - a "delete ram:#? all" doesn't hurt ENV vars.
  35.  - faster booting (no need to copy envarc: to env:)
  36.  
  37.  
  38. INSTALLATION
  39.  Simply copy 'env-handler' to your C: (or L: if you prefer
  40.  it) drawer. Next edit your s:startup-sequence and look for
  41.  the following lines (the lines your s:s-s might look a bit
  42.  different):
  43.  
  44.  MakeDir RAM:ENV
  45.  Assign ENV: RAM:Env
  46.  C:Copy ENVARC:~(#?.info) ENV: ALL QUIET
  47.  
  48.  or when you're upgrading from HappyEnv
  49.  
  50.  MountEnv
  51.  
  52.  and replace them/it with (this line should be placed before the 
  53.  Assigns in your s:s-s).
  54.  
  55.  C:env-handler ADDVOLNODE
  56.  
  57.  The ADDVOLNODE option is optional (that's why it is called an option:).
  58.  If set, env-handler will add the volume "Env Disk" to your system which you
  59.  can access via Workbench or the ASL filerequester. In case you don't
  60.  want to see the Env volume on your wb, you can hide it via workbench
  61.  prefs (os3.5/9). The icon for the Env: volume must be named "def_ENV.info"
  62.  and placed in ENVARC:Sys, alternatively you can also create a "disk.info"
  63.  in ENVARC:
  64.  
  65.  In additon to ADDVOLNODE, the VOLNAME option can be set to change the
  66.  default name of the Env: disk. Eg. VOLNAME=Stephan let you change the
  67.  diskname to Stephan :) Please note that VOLNAME only works when ADDVOLNODE
  68.  is also specified.
  69.  
  70.  
  71. KNOWN PROBLEMS
  72.  Problem: The computer stops booting at "C:InitPPCLib".
  73.  Solution: Make sure that "MakeDir ram:t ram:clipboards" and "l:env-handler"
  74.   is placed before "C:InitPPCLib".
  75.  
  76.  Problem: The old B/W disk icon is shown when working with DiskSalv, 
  77.   ReOrg or any other program that inhibits the system partition.
  78.  Solution: Copy your "def_disk.info" to env:sys instead of letting the
  79.   handler do this when Workbench requests the file. With DefIcons v37
  80.   you also need to copy "def_BUSY.info" and (?) "def_BAD.info" to env:sys.
  81.   
  82.  Problem: ixemul based program don't find env variables.
  83.  Solution: This is more or less a special feature of ixemul, you need to
  84.   copy the variables to env: to workaround this problem.
  85.   
  86.  Problem: The env: disk is much smaller (= less files) than the envarc: 
  87.   drawer.
  88.  Solution: Only files that are in use can be found in env:, all others
  89.   remain in ENVARC: to save memory.
  90.  
  91.  
  92. HISTORY
  93.  1.0  first public release
  94.  1.1  the ACTION_SET_FILE_SIZE packet returned a wrong value on success,
  95.       which made SetEnv fail. Funny, it never happend on my system. Thanks
  96.       to all who have reported this problem. To avoid possible conflicts,
  97.       the Env volume is named "Env Disk", now (when ADDVOLNODE is specified).
  98.  1.2  notification should work on all systems, now. Thanks to Jan-Erik 
  99.       Karlsson for testing.
  100.  1.3  YAM+AppChange problem (Please insert Env: in any drive) solved. 
  101.       AppChange tries to load "Env:def_New:0 Total:0.info" which isn't
  102.       a valid path (because of the 2 additional colons) and therefore
  103.       caused DOS to put the error requester. Thanks to Andreas Kürzinger
  104.       who gave me the "AppChange" tip. Fixed RAWBInfo and DirOpus displaying
  105.       the wrong size for a drawer. "MakeDir env:xyz/" created a nameless
  106.       directory <Robin>. Thanks to D. Dominguez for the spanish
  107.       documentation.
  108.  1.4  reduced memory usage a bit. Fixed another "Please insert Env: in any
  109.       drive" problem. added VOLNAME option. fixed Archive bit usage.
  110.  1.5  came back to some old code because people reported that v1.4 crashs
  111.       on their system.
  112.  1.6  1.4 is back :) Thanks to Andrea Vallinotto and Steve Holland for 
  113.       the debugtool output.
  114.  1.7  fixed another notification problem. Thanks to Dagfinn Olsen for reporting
  115.       and testing.
  116.  1.8  yet another notification bug fixed. Thanks to all who reported the
  117.       problem and tested the new version.
  118.  1.9  examing a directory and deleting its contents at the same time crashed
  119.       the handler because I "killed" the mechanism that should prevent the
  120.       crash ;) <Thomas Richter>.
  121.  1.10 the handler could end up creating variables in the wrong directory
  122.       <Gianfranco Gignina>, <Sinan Gürkan>. Fixed another notification
  123.       issue <Thomas Richter>.
  124.  1.11 the handler crashed when "cloning" (=copying from envarc) a directory
  125.       with a comment <Jan Zahurancik>. This was the same bug 1.4 had when
  126.       copying files from envarc:.
  127.  1.12 replaced an OpenFromLock() with an Open(), some *nix UAE filesystems
  128.       don't support it <James Maurice Battle>.
  129.  
  130.  
  131. AUTHOR
  132.  
  133.  Please send bug reports and ideas to:
  134.  
  135.     Stephan Rupprecht
  136.     Apfeldweg 1
  137.     D44359 Dortmund
  138.     Germany
  139.  
  140.  Send emails to
  141.  
  142.     info@stephan-rupprecht.de
  143.     
  144.  WWW
  145.      http://stephan-rupprecht.de
  146.